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Foreword 



This Technical Specification has been produced by the 3"^ Generation Partnership Project (3GPP). 

3GPP acknowledges the contribution of the Parlay X Web Services specifications from The Parlay Group. The Parlay 
Group is pleased to see 3GPP acknowledge and publish the present document, and the Parlay Group looks forward to 
working with the 3GPP community to improve future versions of the present document. 

The contents of the present document are subject to continuing work within the TSG and may change following formal 
TSG approval. Should the TSG modify the contents of the present document, it will be re-released by the TSG with an 
identifying change of release date and an increase in version number as follows: 

Version x.y.z 

where: 

X the first digit: 

1 presented to TSG for information; 

2 presented to TSG for approval; 

3 or greater indicates TSG approved document under change control. 

y the second digit is incremented for all changes of substance, i.e. technical enhancements, corrections, 
updates, etc. 

z the third digit is incremented when editorial only changes have been incorporated in the document. 



Introduction 



The present document is part 14 of a multi-part deliverable covering the 3' Generation Partnership Project; Technical 
Specification Group Core Network and Terminals; Open Service Access (OSA); Parlay X Web Services, as identified 
below: 

"Common" 
"Third party call" 
"Call Notification" 
"Short Messaging" 
"Multimedia Messaging" 
"Payment" 

"Account management" 
"Terminal Status" 
"Terminal location" 
"Call handling" 
"Audio call" 

"Multimedia conference" 
"Address list management" 
'Presence" 
"Message Broadcast" 
"Geocoding" 

"Application driven Quality of Service (QoS)" 
"Device management" 
"Multimedia streaming control" 
"Multimedia multicast session management" 
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1 Scope 

The present document is Part 14 of the Stage 3 Parlay X Web Services specification for Open Service Access (OS A). 

The OS A specifications define an architecture that enables application developers to make use of network functionality 
through an open standardized interface, i.e. the OSA APIs. The concepts and the functional architecture for the OSA are 
contained in 3GPP TS 23.198 [3]. The requirements for OSA are contained in 3GPP TS 22.127 [2]. 

The present document specifies the Presence Web Service aspects of the interface. All aspects of the Presence Web 
Service are defined here, these being: 

Name spaces. 

Sequence diagrams. 

Data definitions. 

Interface specification plus detailed method descriptions. 

Fault definitions. 

Service policies. 

WSDL Description of the interfaces. 

The present document has been defined jointly between 3GPP TSG CT WG5, ETSI TISPAN and the Parlay 
Consortium. 

2 References 

The following documents contain provisions which, through reference in this text, constitute provisions of the present 
document. 

• References are either specific (identified by date of publication, edition number, version number, etc.) or 
non-specific. 

• For a specific reference, subsequent revisions do not apply. 

• For a non-specific reference, the latest version applies. In the case of a reference to a 3GPP document (including 
a GSM document), a non-specific reference implicitly refers to the latest version of that document in the same 
Release as the present document. 

[I] 3GPP TR 21.905: "Vocabulai-y for 3GPP Specifications". 

[2] 3GPP TS 22. 127: "Service Requirement for the Open Services Access (OSA); Stage 1 ". 

[3] 3GPP TS 23.198: "Open Service Access (OSA); Stage 2". 

[4] 3GPP TS 22.101: "Service aspects; Service principles". 

[5] W3C Recommendation (2 May 2001): "XML Schema Part 2: Datatypes". 

http://www.w3.org/TR/2001/REC-xmlschema-2-20010502/ . 

[6] 3GPP TS 29.199-1: "Open Service Access (OSA); Parlay X Web Services; Part 1: Common". 

[7] Void. 

[8] 3GPP TS 29.198-14: "Open Service Access (OSA) Application Programming Interface (API); 

Part 14: Presence and Availability Management (PAM)". 

[9] RFC 3856: "A Presence Event Package for the Session Initiation Protocol (SIP)". 

http://www.ietf org/rfc/rfc3856.txt 

[10] Void. 

[II] Void. 
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[12] 3GPP TS 23.141: "Presence service; Architecture and functional description; Stage 2". 

[13] 3GPP TS 29.199-13: "Open Service Access (OSA); Parlay X Web Services; Part 13: Address list 

management" . 

[11] IETF RFC 3265 : "Session Initiation Protocol (SlP)-Specific Event Notification" . 

[15] Void. 



Definitions and abbreviations 



3.1 Definitions 

For the purposes of the present document, the terms and definitions given in 3GPP TS 29.199-1 [6] and the following 
apply: 

applications: for Instant Messaging, Push to Talk, or call control and other purposes may become clients of the 

presence Web Service 

We assume that these applications belong to a watcher and authenticate to the services in the name of the watcher. 

identity: represents a user in the real world 

NOTE: See OS A/Parlay PAM identities [8], section 4.4.1. 

presence attributes: contain information about a presentity 

An attribute has a name and a value and can be supplied by any device, application or network module that can be 
associated to the presentity's identity. A watcher can obtains attributes only after he has successfully subscribed to them. 
Examples for attributes are activity, location type, communication means, etc. 

presence information: consists of a set of attributes that characterize the presentity such as current activity, 
environment, communication means and contact addresses 

Only the system and the presentity have direct access to this information, which may be collected and aggregated from 
several devices associated to the presentity. 

subscription: before a watcher can access presence data, he has to subscribe to it 

One possibility the API provides is an end-to-end subscription concept, in which only identities that have accepted a 
subscription to their presence can be addressed. Subscriptions can be also automatically handled by server policies 
edited by the presentity or other authorized users. The service/protocol to manage those policies is out of the scope of 
the present document. 

NOTE: This definition is not related to the term "subscripdon" in 3GPP TR 21.905 [1]. 

watcher and presentity: We use these names to denote the role of the client connected to the presence services 

Like in OSA/Parlay PAM [8] the watcher and the presentity have to be associated to identities registered to the system, 

i.e. users, groups of users or organizations. 

3.2 Abbreviations 

For the purposes of the present document, the abbreviations given in 3GPP TS 29.199-1 [6] and the following apply: 

ACL Access Control List 

DMS Data Manipulation Server 

GM Group Management 

IETF Internet Engineering Task Force 

IMS IP Multimedia Subsystem 

ISC IP multimedia subsystem Service Control interface 

MMS Multimedia Message Service 

PAM Presence and Availability Management 

RLS Resource List Server 

SCF Service Capability Feature 
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SIMPLE SIP for Instant Messaging and Presence Leveraging Extensions 

SIP Session Initiation Protocol 

SMS Short Message Service 

URI Uniform Resource Identifier 

WS Web Service 

WSDL Web Services Definition Language 

XCAP XML Configuration Access Protocol 

XML extensible Markup Language 

XMPP extensible Messaging and Presence Protocol 

XSD XML Schema Definition 



4 Detailed service description 

The presence service allows for presence information to be obtained about one or more users and to register presence 
for the same. It is assumed that the typical client of these interfaces is either a supplier or a consumer of the presence 
information. An Instant Messaging application is a canonical example of such a client of this interface. 

Figure 4.1 shows the architecture of the presence Web Service and the underlying services. The OS A/Parlay PAM SCF 
is the straightforward option and implements the presence server with extended identity, device capability, and presence 
agent management. OS A/Parlay PAM allows aggregation of presence information from internet, mobile and enterprise 
users, etc. using a presence transport network of SIP or XMPP servers. The Presence Web Service can however 
communicate directly for example with IMS presence network elements (presence and resource list servers) using the 
ISC (SIP/SIMPLE) protocol interface. 



watcher 
client 



presentity 
client 



Parlay-X API 




Group 
Management WS 



Parlay-X Presence Web Service 



OSA/Parlay API 



--^d^ 




Network protocols 
(e.g. SIP) 



Figure 4.1 : The PAM Web Service Environment 



Relationship to Similar or Supplanted Specifications: 
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The most important relations are to: 

• Parlay-X Terminal Status and Terminal Location: Both services deal with information that could be considered 
part of the user's presence information. Communication abilities can be derived from terminal status information, 
and the user's placetype can be derived from his location. 

• OSA/Parlay PAM: The OSA/Parlay Presence and Availability specification can be considered the big brother of 
this specification. While ParlayX Presence stays behind OS A PAM in terms of flexibility and power - especially 
concerning attributes and management interfaces - it also extends PAM by introducing end-to-end authorization. 
This specification aims to be mappable to OSA PAM. 

• SIP SIMPLE [9]: This specification aims to be mappable to the SIP/SIMPLE architecture. 

• XMPP (Jabber): Many principles of this specification (see Bibliography) have been adopted, especially the end- 
to-end authorization. 

• IETF Rich Presence (see Bibliography). The set of attributes the present document specifies is closely aligned 
with the lETF's Rich Presence ideas. 

• Group Management [13]: Presence of groups is supported by this specification, however their creation and 
manipulation has to be done using the GM PX Web Service. In the 3GPP presence context, contact lists and 
group manipulation is done with the XCAP protocol (see Bibliography). 



5 Namespaces 

The PresenceConsumer interface uses the namespace: 

http://www.csapi.org/wsdl/parlayx/presence/consumer/v3_2 
The PresenceNotification interfaces use the namespace: 

http://www.csapi.org/wsdl/parlayx/presence/notification/v3_2 
The Presences upplier interfaces use the namespace: 

http://www.csapi.org/wsdl/parlayx/presence/supplier/v3_2 
The PresenceSupplierNotificationManager interfaces use the namespace: 

http://www.csapi.org/wsdl/parlayx/presence_supplier/notification_manager/v3_0 
The Presences upplierNotification interfaces use the namespace: 

http://www.csapi.org/wsdl/parlayx/presence_supplier/notification/v3_0 
The data types are defined in the namespace: 

http://www.csapi.org/schema/parlayx/presence/v3_2 

The 'xsd' namespace is used in the present document to refer to the XML Schema data types defined in 
XML Schema [5]. The use of the name 'xsd' is not semantically significant. 



6 Sequence diagrams 

6.1 Interface flow overview 

The sequence diagram shows the interactions in case both watcher application and presentity are Web Service clients. 
Compared to the SIP interactions, the subscription notification is separated from the delivery of presence information 
itself. Based on the subscription result, the watcher can select the polling or notification mode for presence events. 
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Changes in the authorization of presence attributes are propagated to the watchers via notifySubscription() message, the 
blocking of a subscription by the presentity are propagated via an endSubscriptionNotification message. 

The sequence diagram does not show the internal communication within the presence server. It is assumed that the 
Presence Consumer and Supplier interfaces are implemented by the same instance. If an implementers of the API find 
other solutions preferable, he has to take care of the internal communication himself. 
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Figure : Message interaction overview 
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7 



XML Schema data type definition 



Presence attributes are inspired by the lETF's Rich Presence ideas (see BibHography). 

7.1 PresenceAttributeType enumeration 

The different types of attributes. For each entry in this enumeration there is a separate value type. 



Enumeration 


Description 


Activity 


The presentity's activity (available, busy, lunch, etc.) 


Placelype 


At what kind of place the presentity is (home, office, etc.) 


Privacy 


The amount of privacy the user wants (public, quiet, etc.) 


Sphere 


The user's current environment (work, home) 


Communication 


The user's means of communication (phone, mail, etc.) 


IVlood 


The user's mood (angry, confused, happy, etc.) 


Placels 


Describes the properties of the place the user is currently at. 


TimeOffset 


Describes the number of minutes of offset from UTC that the user is currently at. 


Statuslcon 


Depicts the current status of the user. 


Other 


A name - value pair for arbitrary presence information 



7.2 



ActivityValue enumeration 



This enumeration shows the user's current activity. If the activity is unknown, the attribute value will be 
ActivityNone, meaning the attribute was not set. If the user is doing something not in this list, the value will be set 
to ActivityOther. 



Enumeration 


Description 


ActivityNone 


Not set. 


Appointment 


The user has an appointment. 


Available 


The user is available for communication. 


Busy 


The user is busy and is only available for urgent matters. 


DoNotDisturb 


The user is very busy and does not wish to be disturbed. 


OnThePhone 


The user is on the phone. 


Steering 


The user is driving a car / train / airplane, etc. 


Meeting 


The user is in a meeting. 


Away 


No idea what the user is doing, but he is away. 


Meal 


The user is eating. 


Breakfast 


The user is having breakfast. 


Lunch 


The user is having lunch. 


Dinner 


The user is having dinner. 


PermanentAbsence 


The user is away and will not return for an extended period. 


Vacation 


The user is on vacation. 


Holiday 


A scheduled national or local holiday. 


Performance 


The user is in a theatre / concert. 


InTransit 


The user is in the transit area of an (air)port. 


Travel 


The user is travelling. 


Sleeping 


The user is sleeping. 


LookingForWork 


The user is looking for (paid) work. 


Playing 


The user is occupying him- or herself in amusement, sport, or other recreation. 


Presentation 


The user is giving a presentation, lecture, or participating in a formal round-table discussion. 


Shopping 


The user is visiting stores in search of goods or services. 


Spectator 


The user is observing an event, such as a sports event. 


TV 


The user is watching television. 


Working 


The user is engaged in, typically paid, labor, as part of a profession or job. 


Worship 


The user is participating in religious rites. 


ActivityOther 


The user is doing something not in this list. 
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7.3 PlaceTypeValue enumeration 



This enumeration shows the type of the user's current location. If the place type is unknown, the attribute value will be 
PlaceNone, meaning the attribute was not set. If the user in a place not in this list, the value will be set to 

PlaceOther. 



Enumeration 


Description 


PlaceNone 


Not set. 


Arena 


The user is at an enclosed area used for sports events. 


Home 


The user is at home. 


Office 


The user is in an office. 


PublicTransport 


The user is on public transport. 


Street 


Walking on the street. 


Outdoors 


Generally outdoors. 


PublicPlace 


The user is in a public place. 


Hotel 


The user is in a hotel. 


Theatre 


The user is in a theatre or concert. 


Restaurant 


The user is in a restaurant, coffee shop or, other public dining establishment. 


School 


The user is at school. 


Industrial 


The user is in an industrial building. 


Quiet 


The user is in a quiet area. 


Noisy 


The user is in a noisy area. 


Aircraft 


The user is on an aircraft. 


Watercraft 


The user is on a vessel for travel on water such as a boat or ship. 


Automobile 


The user is in a car. 


Bus 


The user is in a bus. 


BusStation 


The user is in a bus- station. 


TrainStation 


The user is in a train-station. 


ShoppingArea 


The user is in a shopping mall or shopping area. 


Airport 


The user is in an airport. 


Train 


The user is in a train. 


Bank 


The user is in a bank. 


Bar 


The user is in a bar. 


Bicycle 


The user is on a bicycle. 


Cafe 


The user is in a cafe; usually a small and informal establishment that serves various refreshments 
(such as coffee); coffee shop. 


Classroom 


The user is in an academic classroom or lecture hall. 


Club 


The user is in a dance club, nightclub, or discotheque. 


Construction 


The user is at a contstruction site. 


ConventionCenter 


The user is in a convention center or exhibition hall. 


Government 


The user is in a government building, such as those used by the legislative, executive, or judicial 
branches of governments, including court houses, police stations, and military installations. 


Hospital 


The user is in a hospital, hospice, medical clinic, mental institution, or doctor's office. 


Library 


The user is in a library. 


IVIotorcycle 


The user is on a motorcycle. 


Outdoors 


The user outside a building, in or into the open air, such as a park or city streets. 


Parking 


The user is in a parking lot or parking garage. 


PlaceOfWorship 


The user is at a religious site where congregations gather for religious observances, such as a 
church, chapel, meetinghouse, mosque, shrine, synagogue, or temple. 


Prison 


The user is in a prison, penitentiary, jail or a brig. 


Residence 


The user is in a private or residential setting. 


Stadium 


The user is in a stadium. 


Store 


The user is in a shop or store. 


Truck 


The user is in a truck. 


Underway 


The user is in a land-, water-, or aircraft that is underway (in motion). 


Warehouse 


The user is in a warehouse. 


Water 


The user is in, on, or above bodies of water, such as an ocean, lake, river, canal, or other waterway. 


PlaceOther 


The user is in a kind of place not listed here. 
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7.4 Privacy Type enumeration 



This enumeration shows the amount of privacy a user currently has. If the privacy is unknown, the attribute value will 
be PrivacyNone, meaning the attribute was not set. If none of the values apply, the value will be set to 

PrivacyOther. 



Enumeration 


Description 


PrivacyNone 


Not set. 


PrivacyPublic 


The user is surrounded by other people and cannot discuss openly. 


PrivacyPrivate 


The user is alone and able to talk openly. 


PrivacyQuiet 


The user is in a quiet environment and cannot talk at all. 


PrivacyOther 


None of the other values applies. 


PrivacyAudio 


Inappropriate individuals are not likely to overhear audio communications. 


Privacylext 


Inappropriate individuals are not likely to see text communications. 


PrivacyVideo 


Inappropriate individuals are not likely to see video communications. 



7.5 SphereValue enumeration 



This enumeration shows the sphere within which the user acts. If the sphere is unknown, the attribute value will be 
SphereNone, meaning the attribute was not set. If the sphere is not in this list (neither work nor home), the value will 

be set to SphereOther. 



Enumeration 


Description 


SphereNone 


Not set. 


SphereWork 


The user is acting within his work sphere, i.e. as a member of his company 


SphereHome 


The user is acting within his home sphere, i.e. as a private person. 


SphereOther 


The user is acting neither within his work nor within his home sphere. 



7.6 CommunicationlVleansType enumeration 

This enumeration lists communication means. If the communication attribute referrers to a means not in this list, it will 
point to Means Other. 



Enumeration 


Description 


Phone 


The communication attribute refers to a phone (fixed line or mobile or SIP). 


Chat 


The communication attribute refers to a chat client. 


SMS 


The communication attribute refers to an SIVIS client. 


Video 


The communication attribute refers to a video phone (fixed line or mobile or SIP). 


Web 


The communication attribute refers to a web client. 


EMail 


The communication attribute refers to an e-mail client. 


MMS 


The communication attribute refers to an MMS client. 


MeansOther 


The communication attribute refers to any other client. 
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7.7 



CommunicationMeans structure 



This structure describes one way of reaching the presentity or contacts of the presentity. If the presentity for example is 
unavailable he/she may publish communication means for one of his/her contacts. 



Element name 


Element type 


Optional 


Description 


Priority 


xsd:float 


No 


The priority of this communication means. Between 
and 1 , the latter meaning the highest priority. 


Contact 


xsd:anyURI 


No 


The contact address for this communication means. 


Type 


CommunicationMeansType 


No 


The type of this communication means. 


Status 


CommunicationStatusType 


Yes 


The status of this communication means. 


Relationship 


RelationsliipValue 


Yes 


Relationship the presentity has with the contact 
whose communication means address is published. If 
the parameter is not set it means that the 
communication means refers to the presentity 
himself. 



7.8 



CommunicationValue structure 



This structure describes the various ways of reaching a presentity. 



Element name 


Element type 


Optional 


Description 


Means 


CommunicationMeans [0.. unbounded] 


Yes 


The different ways of reaching the presentity. 



7.9 OtherValue structure 

This structure can be used for storing arbitrary data about a presentity. 



Element name 


Element type 


Optional 


Description 


Name 


xsd:string 


No 


Description of the content. 


Value 


xsd:string 


No 


Attribute content. 



7.10 PresenceAttribute structure 

Presence data published by a presentity and retrieved by watchers. 



Element name 


Element type 


Optional 


Description 


LastChange 


xsd:dateTime 


No 


The time and date when the attribute was changed last. 


Note 


xsd:string 


Yes 


An explanatory note. 


TypeAndValue 


AttributeTypeAndValue 


No 


The type of attribute and its associated value. 
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7.10a AttributeTypeAndValue union 



Element name 


Element type 


Optional 


Description 


UnionElement 


PresenceAttributeType 


No 


Type of presence attribute provided (one of the following). 


Activity 


ActivityValue 


Yes 


The presentity's activity (available, busy, lunch, etc.) 


PlaceType 


PlaceTypeValue 


Yes 


At what kind of place the presentity is (home, office, etc.) 


Privacy 


PrivacyValue 


Yes 


The amount of privacy the user wants (public, quiet, etc.) 


Sphere 


SphereValue 


Yes 


The user's current environment (work, home) 


Communication 


CommunicationValue 


Yes 


The user's means of communication (phone, mail, etc.) 


IVIood 


IVIoodValue 


Yes 


The user's mood (angry, confused, happy, etc.) 


Placels 


PlacelsValue 


Yes 


Describes the properties of the place the user is currently at. 


TimeOffset 


TimeOffsetValue 


Yes 


Describes the number of minutes of offset from UTC that the 
user is currently at. 


Statuslcon 


StatuslconValue 


Yes 


Depicts the current status of the user. 


Other 


OtherValue 


Yes 


A name - value pair for arbitrary presence information 



7.1 1 SubscriptionRequest structure 



This structure is returned to the presentity by the Presence Web Service and contains the requesting watcher and the 
attributes he wants to subscribe. 



Element name 


Element type 


Optional 


Description 


Watcher 


xsd:anyURI 


No 


The watcher who wants to gain access to data. 


Attributes 


PresenceAttributeType 
[0.. unbounded] 


Yes 


The attributes the watcher wants to see. An empty array 
means subscription to all attribute types. 


Application 


xsd:string 


No 


The name of the application running on behalf of the watcher. 
Note that this field has solely informative purposes, access 
rights management is based on watcher id only. 



7.12 PresencePermission structure 

The answer from the service to the watcher in the notifySubscriptionRequest message. 



Element name 


Element type 


Optional 


Description 


Attribute 


PresenceAttributeType 


No 


The name of the attribute type the watcher wanted to 
subscribe 


Decision 


xsd:Boolean 


No 


Indicates whether the presentity accepted the subscription to 
the attribute type (true) or rejected it (false). 



7.13 CommunicationStatusType enumeration 

This enumeration shows the status of communication means. 



Enumeration 


Description 


On 


Presentity has his own communication means that is available now. Watcher can connect directly. 


Off 


Presentity has his own communication means that is not available for some reason. 


Busy 


Presentity has his own communication means that is busy. 
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7.14 PrivacyValue Structure 



This structure holds an array of privacy types. A privacy type may indicate whether other parties are hkely to observe a 
specific communication type. 



Element name 


Element type 


Optional 


Description 


Privacylypes 


PrivacyType 
[1... unbounded] 


No 


Array holding privacy types. 



7.15 MoodValue enumeration 

This enumeration shows the type of the user's current mood. If the mood type is unknown, the attribute value will be 
MoodNone, meaning the attribute was not set. If the mood type is not in this list, the value will be set to MoodOther. 



Enumeration 


Description 


Afraid 


The user is afraid. 


Amazed 


The user is amazed. 


Angry 


The user is angry. 


Annoyed 


The user is annoyed. 


Anxious 


The user is anxious. 


Ashamed 


The user is ashamed. 


Bored 


The user is bored. 


Brave 


The user is brave. 


Calm 


The user is calm. 


Cold 


The user is cold. 


Confused 


The user is confused. 


Contented 


The user is contented. 


Cranky 


The user is cranky. 


Curious 


The user is curious. 


Depressed 


The user is depressed. 


Disappointed 


The user is disappointed. 


Disgusted 


The user is disgusted. 


Distracted 


The user is distracted. 


Embarrassed 


The user is embarrassed. 


Excited 


The user is excited. 


Flirtatious 


The user is flirtatious. 


Frustrated 


The user is frustrated. 


Grumpy 


The user is grumpy. 


Guilty 


The user is guilty. 


Happy 


The user is happy. 


Hot 


The user is hot. 


Humbled 


The user is humbled. 


Humiliated 


The user is humiliated. 


Hungry 


The user is hungry. 


Hurt 


The user is hurt. 


Impressed 


The user is impressed. 


In Awe 


The user is in awe. 


InLove 


The user is in love. 


Indignant 


The user is indignant. 


Interested 


The user is interested. 


Invincible 


The user is invincible. 


Jealous 


The user is jealous. 


Lonely 


The user is lonely. 


Mean 


The user is mean. 


MoodNone 


The user's mood is unknown. 


Moody 


The user is moody. 


Nervous 


The user is nervous. 


Neutral 


The user is neutral. 


Offended 


The user is offended. 


Playful 


The user is playful. 


Proud 


The user is proud. 


Relieved 


The user is relieved. 


Remorseful 


The user is remorseful. 


Restless 


The user is restless. 
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Sad 


The user is sad. 


Sarcastic 


The user is sarcastic. 


Serious 


The user is serious. 


Shocl<ed 


The user is shocl<ed. 


Shy 


The user is shy. 


Sick 


The user is sick. 


Sleepy 


The user is sleepy. 


Stressed 


The user is stressed. 


Surprised 


The user is surprised. 


Thirsty 


The user is thirsty. 


Worried 


The user is worried. 


IVIoodOther 


The user's current mood is not listed here. 



7.16 PlacelsValue structure 

This structure holds properties of the place the presentity is currently at, such as the levels of light and noise. This 
information can be used by the watcher to determine the type of communication that is likely to be successful. 



Element name 


Element type 


Optional 


Description 


Audio 


PlacelsAudioValue 


Yes 


Describes place conditions for audio communication. 


Video 


PlacelsVideoValue 


Yes 


Describes place conditions for video communication. 


Text 


PlacelsTextValue 


Yes 


Describes place conditions for real-time and instant- 
messaging communication. 



7.17 PlacelsAudioValue enumeration 

This enumeration shows the properties of the place the presentity is currently at with respect to audio communication. 



Enumeration 


Description 


Noisy 


The user is in a place with a level of background noise that makes audio communications difficult. 


Ok 


The environmental conditions are suitable. 


Quiet 


The user is in a place such as a library, restaurant, place of worship, or theater that discourages noise, 
conversation, and other distractions. 


Unknown 


The place attributes are not known. 



7.18 PlacelsVideoValue enumeration 

This enumeration shows the properties of the place the presentity is currently at with respect to video communication. 



Enumeration 


Description 


TooBright 


The place is too bright for video communication. 


Ok 


The environmental conditions for video communication are acceptable. 


Dark 


The place is too dark for video communication. 


Unknown 


The environmental conditions for video communication are not known. 



7.19 PlacelsTextValue enumeration 



This enumeration shows the properties of the place the presentity is currently at with respect to real-time text and instant 
messaging. 



Enumeration 


Description 


Uncomfortable 


The place is uncomfortable for typing or other text entry. 


Inappropriate 


The place is inappropriate for typing or other text entry. 


Ok 


The environmental conditions are suitable for typing or other text entry. 


Unknown 


The place attributes for text communication is not known. 
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7.20 RelationshipValue enumeration 



This enumeration shows the type of relationship the user has with a contact. If the relationship type is unknown, the 
attribute value will be RelationshipNone, meaning the attribute was not set. If the relationship type is not in this 
list, the value will be set to RelationshipOther. 



Enumeration 


Description 


Family 


The contact is part of the user's family. 


Assistant 


The contact is an assistant of the user, e.g. colleague. 


Friend 


The contact is a friend of the user. 


Associate 


The contact is an associate of the user. 


Supervisor 


The contact is the user's supervisor. 


RelationshipNone 


The relationship type is unknown. 


RelationshipOther 


The relationship type is not in this list. 



7.21 TimeOffsetValue structure 

This structure describes the number of minutes of offset from UTC that the user is currently at. 



Element name 


Element type 


Optional 


Description 


TimeZone 


xsd:string 


Yes 


Describes the time zone. The description is meant for human 
presentation. 


Minutes 


xsd:int 


No 


Number of minutes of offset from UTC that the user is currently at. 



7.22 StatuslconValue structure 

This structure includes a URI pointing to an image that represents the current status of the user. 



Element name 


Element type 


Optional 


Description 


Statuslcon 


xsd:anyURI 


No 


Address to the image (icon) representing the user's current status. 



7.23 Watcher structure 

This structure holds a watcher identity and the authorization status. 



Element name 


Element type 


Optional 


Description 


Watcher 


xsd:anyURI 


No 


The identity of the watcher. 


WatcherSubscriptionStatus 


WatcherSubscriptionStatus 


No 


The status of the watcher's subscription. 



7.24 WatcherSubscriptionStatus enumeration 

This enumeration shows the different statuses a watcher's subscription may have. 



Enumeration 


Description 


Authorised 


Indicates that the watcher's subscription has been authorised by the presentity 


Blocked 


Indicates that the watcher's subscription is currently blocked by the presentity. 


PoliteBlocked 


Indicates that the watcher's subscription is politely blocked by the presentity. 
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8 



Web Service interface definition 



This API is separated into three interfaces: 

• PresenceConsumer interface: watcher methods for requesting and subscribing presence data. 

• PresenceNotification interface: is the watcher notification interface for presence events. 

• PresenceSupplier interface: presentity methods for supplying presence data and managing subscriptions. 



8.1 



Interface: PresenceConsumer 



Client role: watcher. 

This set of methods is used by the watcher to obtain presence data. After the subscription to presence data, the watcher 
can select between a polling mode or a notification mode in order to receive presence data. 



8.1.1 Operation: subscribePresence 



The presentity is contacted and requested to authorize the watcher. As this process generally involves user interaction 
there cannot be an immediate response. The watcher is notified with notifySubscription ( ) . If the presentity is a 
group, every member of the group will be contacted for authorization. The watcher will get one notification for each 
member. 

A service policy may govern the maximum number of allowed presentity URIs provided in the request. Note that the 
policy governs the size of the array holding the URIs. A policy exception (POL0003) will be raised if the value 
provided is not within the policy. Only after the subscription is completed (and the presentity has allowed access to 
attributes) may the watcher get information when he uses getUserPresence ( ) or 
St art PresenceNotification ( ) . 

The Reference part contains the Web Service reference that provides the information necessary for the Presence 
Supplier to notify the watcher with the results of the subscription request. Consistent with the definition provided in 
clause 12.4.1.7 of [6], the correlator element of this Web service reference should be an empty string because the 
presence attribute subscription logic in the watcher application is stateless. 

NOTE: Pending the decision of the presentity concerning the subscription request, the watcher may have invoked 
the subscribePresence operation multiple times: i.e. for different presence attribute types. The response 
from the Presence Supplier thus may reflect the result of multiple, preceding subscription requests by the 
watcher. 

At this interface level, the subscription has no expiration, although at can be ended from the presentity of the underlying 
layers (see subscriptionEnded method). 



8.1.1.1 



Input message: subscribePresenceRequest 



Part name 


Part type 


Optional 


Description 


watcher 


xsd:anyURI 


No 


A watcher who wants to monitor a presentity or a group of 
presentities.Jhe Watcher Application invokes this operation 
on behalf of this watcher. However, it should NOT be 
assumed that the Watcher Application has authenticated the 
watcher. 


Presentities 


xsd:anyURI 
[1... unbounded] 


No 


The presentities whose attributes the watcher wants to 
monitor. The array of presentity URIs may include group 
URIs 


Attributes 


PresenceAttributelype 
[0.. unbounded] 


Yes 


The attribute types the watcher wants to access. (The same 
attribute types for all the group members). An empty array 
means subscription to all attribute types. 


Application 


xsdistring 


No 


Describes the application the watcher needs the data for. 


Reference 


common:SimpleReference 


No 


The notification interface. 



£75/ 



3GPP TS 29.199-14 version 7.3.1 Release 7 



22 



ETSI TS 129 199-14 V7.3.1 (2007-03) 



8.1.1.2 



Output message: subscribePresenceResponse 



Part name 


Part type 


Optional 


Description 


None 









8.1.1.3 Referenced faults 

ServiceException from 3GPP TS 29.199-1 [6]: 

• SVCOOOl: Service error. 

• SVC0002: Invalid input value. 

• S VC0004: No valid addresses - if the presentity address does not exist. 

• SVC0005: Duplicate correlator. 

• SVC0006: Invalid group. 
PolicyException from 3GPP TS 29.199-1 [6]: 

• POLOOOl: Policy error. 

• POL0002: Privacy error. 

• POL0003: Too many addresses 

• POL0006: Groups not allowed. 

• POL0007: Nested groups not allowed. 
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8.1 .2 Operation: getUserPresence 

Returns the aggregated presence data of a presentity. Only the attributes which the watcher is entitled to see will be 
returned. This method does not support group identities. 

Before getting these attributes, the watcher has to subscribe to them (see above). The presentity needs not be informed 
of the access, as he has already consented when the watcher called subscribePresence ( ) . 



8.1.2.1 



Input message: getUserPresenceRequest 



Part name 


Part type 


Optional 


Description 


watcher 


xsd:anyURI 


No 


The watcher who wants to see the presentity's presence data. 
The Watcher Application involves this operation on behalf of 
this watcher. However, it should NOT be assumed that the 
Watcher Application has authenticated the watcher. 


Presentity 


xsd:anyURI 


No 


The presentity whose data the watcher wants to see. 


Attributes 


PresenceAttributelype 
[0.. unbounded] 


Yes 


The attribute types the watcher wants to see. An empty array 
means all attribute types. 



8.1.2.2 



Output message: getUserPresenceResponse 



Part name 


Part type 


Optional 


Description 


Result 


PresenceAttribute [0.. unbounded] 


Yes 


The actual presence data. 



8.1.2.3 Referenced faults 

ServiceException from 3GPP TS 29.199-1 [6]: 

• SVCOOOl: Service error. 

• SVC0002: Invalid input value. 

• S VC0004: No valid addresses - if the presentity address does not exist. 

PolicyException from 3GPP TS 29.199-1 [6]. The presentity has the possibility to cancel or block a subscription by 
manipulating the policy rules. The exception informs the watcher about this status change. 

• POL0002: Privacy error - if the watcher is not subscribed to the requested data. 

• POL0006: Groups not allowed. 
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8.1 .3 Operation: startPresenceNotification 



The notification pattern with correlation is used in order to be able to correlate the notification events with the request. 
The Attributes message part specifies a subset of all possible attribute types that can be subscribed and can be used as a 
filter. 

The watcher sets a notification trigger on certain user presence attribute changes. If the Attributes message part is 
empty, the watcher wants to be notified about changes to all subscribed attribute types. 

In case the presentity is a group the watcher will receive notifications for every single member of the group. 

The watcher will only get notifications for those attributes and presentities he subscribed successfully prior to the call. 

The service will return an array of presentities where the notifications could not be set up. 

A service policy may govern the maximum number of allowed presentity URIs provided in the request. Note that the 
policy governs the size of the array holding the URIs. A policy exception (POL0003) will be raised if the value 
provided is not within the policy. 

The presentity needs not be informed of the access, as he has already consented when the watcher called 

subscribePresence ( ) . 

Note that the SimpleReference contains the correlator string used in subsequent messages to the notification interface. 



8.1.3.1 



Input message: startPresenceNotification Request 



Part name 


Part type 


Optional 


Description 


watcher 


xsd:anyURI 


No 


The watcher who wants to monitor the presentity's 
presence data. The Watcher Application invol<es this 
operation on behalf of this watcher. However, it should 
NOT be assumed that the Watcher Application has 
authenticated the watcher. 


Presentities 


xsd:anyURI 

[1 ... unbounded] 


No 


The presentities whose attribute types the watcher wants 
to monitor. The array of presentity URIs may include 
group URIs. 


Attributes 


PresenceAttributelype 
[0.. unbounded] 


Yes 


The attribute types the watcher wants to monitor. An 
empty array means monitoring of all attribute types. 


Reference 


common:SimpleReference 


No 


The notification interface 


Frequency 


common:TimelVletric 


No 


IVIaximum frequency of notifications (can also be 
considered minimum time between notifications). In case 
of a group subscription the service must make sure this 
frequency is not violated by notifications for various 
members of the group, especially in combination with 
check Immediate. 


Duration 


common:TimelVletric 


Yes 


Length of time notifications occur for, do not specify to 
use default notification time defined by service policy. 


Count 


xsd:int 


Yes 


IVIaximum number of notifications. For no maximum, 
either do not specify this part or specify a value of zero. 


Checl<lmmediate 


xsd:boolean 


No 


Whether to check status immediately after establishing 
notification. 



8.1.3.2 



Output message: startPresenceNotification Response 



Part name 


Part type 


Optional 


Description 


result 


xsd:anyURI 
[0.. unbounded] 


Yes 


The presentities for which the requested notifications could not be set 
up. Empty if notifications were set up for all the specified presentities. 
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8.1.3.3 Referenced faults 

ServiceException from 3GPP TS 29.199-1 [6]: 

• S VCOOO 1 : Service error. 

• SVC0002: Invalid input value. 

• S VC0004: No valid addresses - if the presentity URI does not exist. 

• SVC0005: Duplicate correlator. 

• SVC0006: Invalid group. 

PolicyException from 3GPP TS 29.199-1 [6]. The presentity has the possibility to cancel or block a subscription by 
manipulating the policy rules. The exception informs the watcher about this status change. 

POL0001:PoHcy error. 

POL0002: Privacy error. 

POL0003: Too many addresses 

POL0004: Unlimited notifications not supported. 

POL0005: Too many notifications requested. 

POL0006: Groups not allowed. 

POL0007: Nested groups not allowed. 

POL0009: Invalid frequency requested. 
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8.1.4 Operation: endPresenceNotification 

Indicates that the watcher does not want further notifications for a specific notification request (identified by the 
correlator). Note that the subscription to presence data stays active; the caller of this method remains a watcher and can 
still use getUserPresenceO or reactivate the notifications. 



8.1.4.1 



Input message: endPresenceNotificationsRequest 



L Part name 


Part type 


Optional 


Description 


Correlator 


xsd:string 


No 


The notification the watcher wants to cancel. 



8.1 .4.2 Output message: endPresenceNotificationResponse 



Part name 


Part type 


Optional 


Description 


None 









8.1 .4.3 Referenced faults 

ServiceException from 3GPP TS 29.199-1 [6]: 

• SVCOOOl: Service error. 

• SVC0002: Invahd input value. 
PohcyException from 3GPP TS 29.199-1 [6]: 

• POLOOO 1 : PoUcy error. 
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8.2 



Interface: PresenceNotification 



This client callback interface is used by the presence consumer interface to send notifications. 

8.2.1 Operation: statusChanged 

The asynchronous operation is called by the Web Service when an attribute for which notifications were requested 
changes. 



8.2.1.1 



Input message: statusChanged Request 



Part name 


Part type 


Optional 


Description 


Correlator 


xsd:string 


No 


Identifies the notification request 


Presentity 


xsd:anyURI 


No 


The presentity whose presence status has 
changed 


ChangedAttributes 


PresenceAttribute [1.. unbounded] 


No 


The new presence data 



8.2.1 .2 Output message: statusChangedResponse 



Part name 


Part type 


Optional 


Description 


None 









8.2.1.3 

None. 



Referenced faults 



8.2.2 Operation: statusEnd 



The notifications have ended for this correlator. This message will be delivered when the duration or count for 
notifications have been completed. This message will not be delivered in the case of an error ending the notifications or 
deliberate ending of the notifications (using endPresenceNotification operation). 



8.2.2.1 



Input message: statusEndRequest 



Part name 


Part type 


Optional 


Description 


Correlator 


xsd:string 


No 


Correlator provided in request to set up this notification 



8.2.2.2 



Output message: statusEndResponse 



Part name 


Part type 


Optional 


Description 


None 









8.2.2.3 

None. 



Referenced faults 
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8.2.3 Operation: notifySubscription 

This asynchronous method notifies the watcher that the server or the presentity handled the pending subscription. 

NOTE: There is no correlator message part for reasons explained in clause 8. 1 . 1 ; i.e. in the description of the 
subscribePresence operation. 



8.2.3.1 



Input message: notifySubscription Request 



Part name 


Part type 


Optional 


Description 


Presentity 


xsd:anyURI 


No 


The presentity whose attribute types the watcher wants to monitor 


watcher 


xsd:anyURI 


No 


The watcher who wants to monitor the presentity's presence data. 
It has the same value as the watcher part of the original 
subscribePresenceRequest message (reference clause 8.1.1.1). 


Decisions 


PresencePermission 
[0.. unbounded] 


Yes 


Denotes the decision of the server/presentity to the subscription 
request for each attribute type. An empty array means subscription 
accepted for all requested attribute types. 



8.2.3.2 



Output message: notifySubscription Response 



Part name 


Part type 


Optional 


Description 


None 









8.2.4 Operation: subscriptionEnded 



This asynchronous operation is called by the Web Service to notify the watcher (application) that the subscription has 
terminated. Typical reasons are a timeout of the underlying SIP soft state subscription (in accordance with [14] and [9]) 
or the decision of the presentity to block further presence information to that watcher. Since the subscription request has 
no expiration parameters, the service implementation may provide an inactivity timer that also triggers the 
subscriptionEnded message. 

NOTE: There is no correlator message part for reasons explained in clause 8. 1 . 1 ; i.e. in the description of the 
subscribePresence operation. 



8.2.4.1 



Input message: subscriptionEndedRequest 



Part name 


Part type 


Optional 


Description 


Presentity 


xsd:anyURI 


No 


The presentity to which the subscription has terminated 


watcher 


xsdianyURI 


No 


The watcher whose subscription is terminated. 

It has the same value as the watcher part of the original 

subscribePresenceRequest message (reference clause 8.1 .1 .1 ). 


Reason 


xsd:string 


No 


Timeout, Blocked 



8.2.4.2 



Output message: subscriptionEndedResponse 



Part name 


Part type 


Optional 


Description 


None 
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8.3 Interface: PresenceSupplier 

These methods are used by the presentity to supply presence data and manage access to the data by its watchers. We 
assume that the presentity has been previously authenticated, so that his Identity is known. 

8.3.1 Operation: publish 

The presentity publishes data about herself. This data will then be filtered by the system and forwarded to the watchers 
who have ordered notifications. 



8.3.1.1 



Input message: publishRequest 



Part 
name 


Part type 


Optional 


Description 


Presentity 


xsd:anyURI 


No 


The presentity wlio wants to publish his or her presence data. 
The Presentity Application invokes this operation on behalf of this 
presentity. However, it should NOT be assumed that the 
Presentity Application has authenticated the presentity. 


Presence 


PresenceAttribute 
[0.. unbounded] 


Yes 


The presence attributes the devices of the presentity supports 



8.3.1.2 



Output message: publishResponse 



Part name 


Part type 


Optional 


Description 


None 









8.3.1.3 Referenced faults 

ServiceException from 3GPP TS 29.199-1 [6]: 

• SVCOOOl: Service error. 

• SVC0002: Invalid input value. 
PoHcyException from 3GPP TS 29.199-1 [6]: 

• POLOOOl: Policy error. 
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8.3.2 Operation: getOpenSubscriptions 

Called periodically by the presentity to see if any watchers wants to subscribe to presence data. The client will answer 
open requests with updateSubscriptionAuthorization ( ) . 



8.3.2.1 



Input message: getOpenSubscriptionsRequest 



Part name 


Part type 


Optional 


Description 


presentity 


xsd:anyURI 


No 


The presentity who wants to get watchers to subscribe to his or her presence 
data. The Presentity Application invokes this operation on behalf of this 
presentity. However, it should NOT be assumed that the Presentity 
Application has authenticated the presentity. 



8.3.2.2 



Output message: getOpenSubscriptionsResponse 



Part name 


Part type 


Optional 


Description 


result 


SubscriptionRequest [0.. unbounded] 


Yes 


Any open requests 



8.3.2.3 Referenced faults 

ServiceException from 3GPP TS 29.199-1 [6]: 

• S VCOOO 1 : Service error. 
PohcyException from 3GPP TS 29.199-1 [6]: 

• POLOOOl: Policy error. 

8.3.3 Operation: updateSubscriptionAutlnorization 

The presentity answers with this operation to watchers' subscriptions for which no authorization policy exists. The 
answer consists of the attribute and the watchers involved and the permissions for each attribute. Subscription requests 
that are not answered are assumed pending. 

The operation can be used by the presentity to change anytime the authorization for certain watchers or groups 
monitoring one or several attributes. 

A service policy may govern the maximum number of allowed watcher URIs provided in the request. Note that the 
policy governs the size of the array holding the watcher URIs. A policy exception (POL0003) will be raised if the value 
provided is not within the policy. 

If a watcher did not try to subscribe to the attribute - i.e. there is no pending subscription from the watcher to an 
attribute in the decisions array, a PresenceException will be raised and the entire authorization request ignored. 

The presentity may respond to the watchers request with PoliteBlock set to true. In this case the watcher must not be 
considered authorised by the presentity, but this information must not be disclosed to the watcher. Instead, the watcher 
should be notified that the request was authorised, but the watcher should only be able to retrieve either no presence 
information or presence information dedicated for the polite block feature. It is the responsibility of the Presence Web 
Service to decide what presence information to publish to watchers whose subscription is politely blocked. 
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8.3.3.1 



Input message: updateSubscriptionAuthorizationRequest 



Part name 


Part type 


Optional 


Description 


presentity 


xsd:anyURI 


No 


Presentity wlio wants to update his or her subscriber's authorization. 
The Presentity Application invol<es this operation on behalf of this 
presentity. However, it should NOT be assumed that the Presentity 
Application has authenticated the presentity. 


Watchers 


xsd:anyURI 
[1... unbounded] 


No 


The watchers whom the presentity wants to update the subscription 
for. The array of watchers URIs may include group URIs. 


Decisions 


PresencePermission 
[0.. unbounded] 


Yes 


The answers to open requests. An empty array means subscription 
accepted for all requested attribute types. 


PoliteBlocl< 


xsd:boolean 


No 


If PoliteBlock is true the decisions must be ignored, and the watcher 
is considered not authorised, but this must not be revealed to the 
watcher. The Presence Web Service shall decide what information 
to publish as polite block presence. If false the attributes will be 
published as specified by Decisions. 



8.3.3.2 



Output message updateSubscriptionAuthorization Response 



Part name 


Part type 


Optional 


Description 


None 









8.3.3.3 Referenced faults 

ServiceException from 3GPP TS 29.199-1 [6]: 

• SVCOOOl: Service error. 

• SVC0002: Invalid input value. 

• SVC0004: No valid addresses. 

• SVC0006: Invalid group. 

• SVC0220: No subscription request. 
PolicyException from 3GPP TS 29.199-1 [6]: 

• POLOOOl: Policy error. 

• POL0002: Privacy error. 

• POL0003: Too many addresses 

• POL0006: Groups not allowed. 

• POL0007: Nested groups not allowed. 
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8.3.4 Operation: getMyWatchers 

Returns an array of watching identities for a specific presentity. The watchers' status is included in the response to the 
cHent. The client may apply a filter to retrieve watchers based on subscription status. 



8.3.4.1 



Input message: getMyWatchersRequest 



Part name 


Part type 


Option 
al 


Description 


Presentity 


xsd:anyURI 


No 


Presentity who wants to l<now his or her watchers. The 
Presentity Application Invokes this operation on behalf of 
this presentity. However, It should NOT be assumed that 
the Presentity Application has authenticated the presentity. 


WatcherSubscri 
ptionStatus 


WatcherSubscriptionStatus 
[0 ... unbounded] 


Yes 


Allows the presentity to apply a filter based on watcher 
subscription status. An empty list means the presentity 
wants to retrieve all watchers. 



8.3.4.2 



Output message: getMyWatchersResponse 



Part 
name 


Part type 


Optional 


Description 


Result 


Watcher 

[0.. unbounded] 


Yes 


The list of watcher identities that currently have requested access 
to the presentity's attributes, The subscription status of each 
watcher is included in the response. 



8.3.4.3 Referenced faults 

ServiceException from 3GPP TS 29.199-1 [6]: 

• SVCOOOl: Service error. 

• SVC0002: InvaUd input value. 
PohcyException from 3GPP TS 29.199-1 [6]: 

• POLOOOl: Policy error. 

• POL0002: Privacy error. 
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8.3.5 Operation: getSubscribedAttributes 

Returns an array of attributes that a specific watcher has subscribed. 



8.3.5.1 



Input message: getSubscribedAttributesRequest 



Part 
name 


Part type 


Optional 


Description 


presentity 


xsd:anyURI 


No 


The presentity who wants to know the attributes to which his or her watcher has 
subscribed. The Presentity Application invol<es this operation on behalf of this 
presentity. However, it should NOT be assumed that the Presentity Application 
has authenticated the presentity. 


Watcher 


xsd:anyURI 


No 


The watcher whose subscriptions the presentity wants to know 



8.3.5.2 



Output message: getSubscribedAttributesResponse 



Part 
, name 


Part type 


Optional 


Description 


Result 


PresenceAttributeType 
[0.. unbounded] 


Yes 


The attributes the watcher is subscribed to. An empty array 
means subscription to all attribute types. 



8.3.5.3 Referenced faults 

ServiceException from 3GPP TS 29.199-1 [6]: 

• S VCOOO 1 : Service error. 

• SVC0004: No vaHd addresses. 

• S VC022 1 : Not a watcher - if the URI in the field watcher is not a watcher of the presentity. 
PohcyException from 3GPP TS 29.199-1 [6]: 

• POLOOOl: Policy error. 
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8.3.6 Operation: blockSubscription 

With this operation the presentity can block entirely the flow of presence information to a certain subscribed watcher by 
cancelling the subscription. The watcher will be notified with an subscriptionEnded() message. 



8.3.6.1 



Input message: blockSubscriptionRequest 



Part 
name 


Part type 


Optional 


Description 


Presentity 


xsd:anyURI 


No 


The presentity who wants to block the watcher. The Presentity Application 
invokes this operation on behalf of this presentity. However, it should NOT be 
assumed that the Presentity Application has authenticated the presentity. 


Watcher 


xsd:anyURI 


No 


The watcher whose subscriptions the presentity wants to cancel 



8.3.6.2 



Output message: blockSubscriptionResponse 



Part name 


Part type 


Optional 


Description 


None 









8.3.6.3 Referenced faults 

ServiceException from 3GPP TS 29.199-1 [6]: 

• SVCOOOl: Service error. 

• SVC0002: Invalid input value. 

• SVC0004: No vaHd addresses. 

• S VC0221 : Not a watcher - if the URI in the field watcher is not a watcher of the presentity. 
PohcyException from 3GPP TS 29.199-1 [6]: 

• POLOOOl: Policy error. 
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8.4 Interface: PresenceSupplierNotificationManager 

This interface enables applications to set up and tear down notifications for open watcher subscriptions. 
After the notification has been established the presentity will be notified with notifyOpenSubscription when a 
subscribePresence operation is invoked by a watcher. 

8.4.1 Operation: StartSubscriptionNotification 

The PresenceSupplierNotificationManager provides functionality that allows presentities to be notified about new open 
subscriptions. 

The Checklmmediate parameter allows the application to request an immediate notification after the notification is 
established. All open subscriptions will be included in the notification. 

The application may specify the duration for how long the notifications should occur with the Duration parameter. If the 
parameter is absent the notification will last until the application invokes EndNotification. 

The correlator provided in the reference must be unique for the application at the time the notification is initiated, 
otherwise a ServiceException (SVC0005) will be returned to the application. 



8.4.1.1 



Input message: StartSubscriptionNotificationRequest 



Part name 


Part type 


Optional 


Description 


Reference 


common:SimpleReference 


No 


Notification endpoint definition 


Presentities 


xsd:anyURI 
[1.. unbounded] 


No 


The presentities for wliich tlie application wants to receive 
notifications of open watcher subscription requests. The 
array of presentity URIs may include group URIs. 


Duration 


commoniTimelVletric 


Yes 


Length of time notifications occur for. If the element is 
omitted the notifications will continue until EndNotification 
is invoked. 


Checl<lmmediate 


xsd: boolean 


No 


Return all open subscriptions immediately after 
establishing notification. 



8.4.1.2 



Output message: StartSubscriptionNotificationResponse 



Part Name 


Part Type 


Optional 


Description 


none 









8.4.1.3 Referenced Faults 

ServiceException from 3GPP TS 29.199-1 [6]: 

• S VCOOO 1 : Service error. 

• SVC0002: Invalid input value. 

• SVC0004: No vaUd addresses. 

• SVC0005: Duplicate correlator. 

• SVC0006: InvaUd group. 

• SVC0008: Overlapping criteria 
PoHcyException from 3GPP TS 29.199-1 [6]: 

• POLOOOl: Policy error. 

• POL0002: Privacy error. 
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• POL0003: Too many addresses. 

• POL0004: Unlimited notifications not supported. 

• POL0006: Groups not allowed. 

• POL0007: Nested groups not allowed. 

8.4.2 Operation: EndNotification 

The presentity application ends notifications for open subscriptions using this operation. 
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8.4.2.1 



Input message: EndNotificationRequest 



Part name 


Part type 


Optional 


Description 


Correlator 


xsd:string 


No 


Correlator of request to end 



8.4.2.2 



Output message: EndNotification Response 



Part Name 


Part Type 


Optional 


Description 


None 









8.4.2.3 Referenced Faults 

ServiceException from 3GPP TS 29.199-1 [6]: 

• SVCOOOl - Service error 

• SVC0002 - Invalid input value 
PolicyException from 3GPP TS 29.199-1 [6]: 

• POLOOO 1 - Policy error 



£75/ 



3GPP TS 29.199-14 version 7.3.1 Release 7 



37 



ETSI TS 129 199-14 V7.3.1 (2007-03) 



8.5 Interface: PresenceSupplierNotification 

This client interface is used to notify the presentity of new open watcher subscriptions. 

8.5.1 Operation: notifyOpenSubscription 

The asynchronous operation is called by the Presence Web Service to inform the client of new open subscriptions. The 
client will answer open requests by invoking the updateSubscriptionAuthorization or blockSubscription operations. 



8.5.1.1 



Input message: notifyOpenSubscription Request 



Part name 


Part type 


Optional 


Description 


Correlator 


xsd:string 


No 


Correlator 


Presentity 


xsd:anyURI 


No 


The presentity that the open subscription refers to. 


SubscriptionRequests 


SubscriptionRequest 
[1 ... unbounded] 


No 


Describes the watcher subscription requests 



8.5.1.2 



Output message: notifyOpenSubscription Response 



Part name 


Part type 


Optional 


Description 


None 









8.5.1.3 

None. 



Referenced faults 



8.5.2 Operation: notifyError 



The notifyError operation is invoked to indicate that the notification for a presentity, or for the whole notification, is 
being cancelled by the Web Service. 



8.5.2.1 



Input message: notifyErrorRequest 



Part 
name 


Part type 


Optional 


Description 


Correlator 


xsd:string 


No 


Correlator provided in request to set up this notification. 


Presentity 


xsd:anyURI 


Yes 


Presentity identifier if the error applies to an individual presentity, or 
not specified if it applies to the whole notification. 


Reason 


common:ServiceError 


No 


Reason notification is being discontinued. 



8.5.2.2 



Output message: notifyErrorResponse 



Part name 


Part type 


Optional 


Description 


None 









8.5.2.3 

None. 



Referenced faults 
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8.5.3 Operation: notifyEnd 

The notifications have completed for this correlator. This message will be delivered when the duration for notifications 
has expired. This message will not be delivered in the case of an error ending the notifications or deliberate ending of 
the notifications (using endNotification operation). 

8.5.3.1 Input message: notifyEnd Request 



Part name 


Part type 


Optional 


Description j 


Correlator 


xsd:string 


No 


Correlator provided in request to set up this notification. 



8.5.3.2 Output message: notifyEndResponse 



Part name 


Part type 


Optional 


Description 


None 









8.5.3.3 

None. 



Referenced faults 
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9 Fault definitions 

9.1 ServiceException 



From 3GPPTS 29.199-1 [6]. 



9.1 .1 SVC0220: No subscription request 



Name 


Description 


Message Id 


SVC0220 


Text 


No subscription request from watcher %1 for attribute %2 


Variables 


%1 - watcher URI 

%2 - type of attribute, from clause 7.1 



9.1.2 SVC0221 : Not a watciner 



Name 


Description 


Message Id 


SVC0221 


Text 


%1 is not a watcher 


Variables 


%1 - watcher URI 



1 Service po icies 


Name 


Type 


Description 


MaximumNotificationFrequency 


common:TimeMetric 


Maximum rate of notification delivery (also can be considered 
minimum time between notifications) 


MaximumNotificationDuration 


common:TimeMetric 


Maximum amount of time a notification may be set up for 


DefaultNotificationDuration 


common :TimeMetric 


Default amount of time a notification will be set up for. 


MaximumCount 


xsd:int 


Maximum number of notifications that may be requested 


UnlimitedCountAllowed 


xsd;boolean 


Allowed to specify unlimited notification count (i.e. either by not 
specifying the optional Count message part in 
StartPresenceNotificationRequest or by specifying a value of 
zero) 


GroupSupport 


xsd:boolean 


Groups may be included with addresses 


NestedGroupSupport 


xsd:boolean 


Are nested groups supported in group definitions 


Maximumldentifiers 


xsd:int 


Maximum number of allowed URIs provided in a request. 
A group URI shall be considered as one URI. 
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Annex A (normative): 
WSDL of Presence API 



The document/literal WSDL representation of this interface specification is compliant to 3GPP TS 29.199-1 [6] and is 
contained in text files (contained in archive 29199-14-730-doclit.zip) which accompanies the present document. 
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Annex C (informative): 

Description of Parlay X Web Services Part 14: Presence for 

3GPP2 cdma2000 networks 

This annex is intended to define the OSA Parlay X Web Services Stage 3 interface definitions and it provides the 
complete OSA specifications. It is an extension of OSA Parlay X Web Services specifications capabilities to enable 
operation in cdma2000 systems environment. They are in alignment with 3GPP2 Stage 1 requirements and Stage 2 
architecture defined in: 

[1] 3GPP2 X.SOOll-D: "cdma2000 Wireless IP Network Standard ", Version 1.1 

[2] 3GPP2 S.R0037-0: "IP Network Architecture Model for cdma2000 Spread Spectrum Systems", 

Version 3.0 

[3] 3GPP2 X.S0013-A: "All-IP Core Network Multimedia Domain" 

These requirements are expressed as additions to and/or exclusions from the 3GPP Release 7 specification. 

The information given here is to be used by developers in 3GPP2 cdma2000 network architecture to interpret the 3GPP 

OSA specifications. 



C.1 General Exceptions 



The terms 3GPP and UMTS are not applicable for the cdma2000 family of standards. Nevertheless these terms are used 
(3GPP TR 21.905) mostly in the broader sense of "3G Wireless System". If not stated otherwise there are no additions 
or exclusions required. 

CAMEL mappings are not applicable for cdma2000 systems. 



C.2 Specific Exceptions 
C.2.1 Clause 1: Scope 

There are no additions or exclusions. 

C.2.2 Clause 2: References 

There are no additions or exclusions. 

C.2. 3 Clause 3: Definitions and abbreviations 

There are no additions or exclusions. 

C.2. 4 Clause 4: Detailed service description 

There are no additions or exclusions. 

C.2. 5 Clause 5: Namespaces 

There are no additions or exclusions. 
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C.2.6 Clause 6: Sequence diagrams 

There are no additions or exclusions. 

C.2.7 Clause 7: XML Schema data type definition 

There are no additions or exclusions. 

C.2.8 Clause 8: Web Service interface definition 

There are no additions or exclusions. 

C.2.9 Clause 9: Fault definitions 

There are no additions or exclusions. 

C.2.10 Clause 10: Service policies 

There are no additions or exclusions. 

C.2.1 1 Annex A (normative): WSDL of Presence API 

There are no additions or exclusions. 
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Annex D (informative): 
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